IRIX 6.5 Complementary Applications 2004 February/SGI IRIX 6.5 Complementary Applications 2004 February.iso/dist/cde.idb/usr/dt/dthelp/help4help/C/Reference.z/Reference

Text File | 2003-11-18 | 26.0 KB | 992 lines

<!-- Reference -->

<!-- Copyright 2000, Silicon Graphics, Inc. -->
<!-- ALL RIGHTS RESERVED -->

<!-- UNPUBLISHED Rights reserved under the copyright laws of the United -->
<!-- States.   Use of a copyright notice is precautionary only and does not -->
<!-- imply publication or disclosure. -->

<!-- U.S. GOVERNMENT RESTRICTED RIGHTS LEGEND: -->
<!-- Use, duplication or disclosure by the Government is subject to restrictions -->
<!-- as set forth in FAR 52.227.19(c)(2) or subparagraph (c)(1)(ii) of the Rights -->
<!-- in Technical Data and Computer Software clause at DFARS 252.227-7013 and/or -->
<!-- in similar or successor clauses in the FAR, or the DOD or NASA FAR -->
<!-- Supplement.  Contractor/manufacturer is Silicon Graphics, Inc., -->
<!-- 2011 N. Shoreline Blvd. Mountain View, CA 94039-7311. -->

<!-- THE CONTENT OF THIS WORK CONTAINS CONFIDENTIAL AND PROPRIETARY -->
<!-- INFORMATION OF SILICON GRAPHICS, INC. ANY DUPLICATION, MODIFICATION, -->
<!-- DISTRIBUTION, OR DISCLOSURE IN ANY FORM, IN WHOLE, OR IN PART, IS STRICTLY -->
<!-- PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN PERMISSION OF SILICON -->
<!-- GRAPHICS, INC.  -->
<!-- Help volume: Help4Help -->
<!-- File name:   Reference -->

<chapter id=Reference>Help Reference

<idx |reference|

<list bullet tight>
 * <xref HelpMenuCommands>
 * <xref HelpMenuShortcutKeys>
 * <xref Mouse-And-Keyboard>
 * <xref HelpWindowsAndDialogBoxes>
 * <xref HelpWindowConfiguration>
 * <xref ErrorMessages>
<\list>

<procedure>See Also
<list bullet tight>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>

<s1 id=HelpMenuCommands>Help Menus

<idx |help window menus|
<idx |menus, in help window|

The Help menus in the help window are:
<list bullet>
* <xref Help-File-Menu>
* <xref Help-Edit-Menu>
* <xref Help-Search-Menu>
* <xref Help-Navigate-Menu>
* <xref Help-Help-Menu>
* <xref Help-Popup-Menu>
<\list>

<procedure>See Also
<list bullet tight>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>

<idx |help window menus|

<p>&sigspace;

<s2 id=Help-File-Menu>Help File Menu

<idx |help, File menu|

<lablist nowrap>
\Print      \Opens the Print dialog
<location id=HelpMenuPrint>∅<\location>


\Close      \Closes the help window
<location id=HelpMenuClose>∅<\location>

<\lablist>
<note>
When using <link ToBrowseDesktopHelp>Help Manager<\link> to view help information, the
Help File menu includes a New Window command.
<\note>

<location id=HelpMenuNewWindow>∅<\location>
<lablist nowrap>
\New Window \Creates a copy of the current general help
   window
<\lablist>

<procedure>See Also
<list bullet tight>
 * <xref Printing>
 * <xref ToBrowseDesktopHelp>
 * <xref HelpMenuCommands>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>

<s2 id=Help-Edit-Menu>Help Edit Menu

<idx |help, Edit menu|

<lablist nowrap>
\Copy  \Copies selected text to the clipboard
<\lablist>

<procedure>See Also
<list bullet tight>
 * <xref CopyingTextFromHelp>
 * <xref HelpMenuCommands>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>

<s2 id=Help-Search-Menu>Help Search Menu

<idx |help, Search menu|

<lablist nowrap>

\Index \Opens the Index Search dialog box, which lists
   the help volume's key words and phrases

<\lablist>

<procedure>See Also
<list bullet tight>
 * <xref Index-Search>
 * <xref HelpMenuCommands>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>

<s2 id=Help-Navigate-Menu>Help Navigate Menu

<idx |help, Navigate menu|

<lablist nowrap>

\Backtrack \ Returns to the previous topic.

\Home Topic  \Takes you to the "home topic," or the first
topic of a help volume.

\History  \Opens the History dialog box, which lists help volumes and
topics you've visited.

<\lablist>

<note>
The Backtrack and Home Topic commands are available in a pop-up menu
in the topic display area.
<\note>

<procedure>See Also
<list bullet tight>
 * <xref ToReturnToAPreviousTopic>
 * <xref ToReturnToTheHomeTopic>
 * <xref History>
 * <xref Help-Popup-Menu>
 * <xref HelpMenuCommands>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>

<s2 id=Help-Help-Menu>Help Menu

<idx |help, Help menu|

<lablist nowrap>

\Overview - Using Help&sigspace;\  Provides help on using help windows

\Table Of Contents \ Displays an outline of the topics in a help volume

\Tasks \ Displays task instructions for using the Help System

\Reference\ Displays reference summaries for various Help features, such
as windows and dialog boxes, menus, and resources

\Mouse And Keyboard \  Provides information on using the mouse and keyboard
commands in help windows

\About Help\ Displays the version and copyright information for the Help System
<\lablist>

<procedure>See Also
<list bullet tight>
 * <xref HelpMenuCommands>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>

<s2 id=Help-Popup-Menu>Help Pop-up Menu

A Help pop-up menu is available in a <link GeneralHelpWindow>general help window<\link>. To display
the pop-up menu, point to the topic display area and
press mouse button 3. <newline>
(On a two-button mouse, press both buttons simultaneously.)


<lablist nowrap>
\Bactrack   \ Returns to the previous topic.
\Home Topic \  Returns to the first topic of a help volume.
<\lablist>

<procedure>See Also
<list bullet tight>
 * <xref ToReturnToAPreviousTopic>
 * <xref ToReturnToTheHomeTopic>
 * <xref HelpMenuCommands>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>

<s1 id=HelpMenuShortcutKeys>Help Menu Shortcut Keys

<idx |help, shortcut keys|
<idx |shortcut keys|
<idx |accelerator keys|

Use these shortcut keys to activate Help menu commands:

<lablist nowrap>
<labheads> \ Command \ Shortcut Key

\Print\          Control+P
\Close\          Alt+F4
\Copy\           Control+C
\Index\          Control+I
\Backtrack\      Control+B
\HomeTopic\      Control+H
<\lablist>

<note>If your keyboard does not have an Alt key,
ask your system administrator to identify the corresponding key or
refer to your system documentation.
<\note>

<p>&sigspace;

<procedure>See Also
<list bullet tight>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>

<s1 id=Mouse-And-Keyboard>Mouse Actions and Keyboard Commands

<idx |keyboard selection|
<idx |text, selecting with keyboard|
<idx |selection, with keyboard|
<idx |keyboard commands|
<idx |mouse, actions in help windows|

<procedure>Mouse Actions

<lablist nowrap>
<labheads>\Action&sigspace;\                 Behavior
\Click mouse button 1           \Selects a topic in the topic tree or a
hyperlink and displays the content in the current help window.
\Hold mouse button 1 and drag            \Copies selected text to the clipboard.

\Control+button&sigspace;1      \Selects a topic in the topic tree or
hyperlink and displays the content in a new window.

\Shift+button&sigspace;1      \Same as above.
\Alt+button&sigspace;1    \Same as above.
<\lablist>

<note>
If your keyboard does not have an Alt key ask your system administrator to
identify the corresponding key or refer to your system documentation.
<\note>

<p>&sigspace;

<procedure>Keyboard Commands

<idx |keyboard, selecting topics|
<idx |topics, selecting with keyboard|

To use your keyboard to display topics or to scroll data, first
move the window selection highlight to the appropriate area of
the help window, such as the topic tree or topic display area.
Press the Tab key to move the selection highlight forward. To move
the highlight backward, press Shift+Tab.

You can use these keyboard commands in the following help window
areas:


<list bullet>
* <term nogloss |Topic Tree|

<lablist nowrap>
<labheads>\Key       \ Cursor Action
\ Up Arrow               \ Up one line
\ Down Arrow             \ Down one line
\ Return              \ Display help topic for selected title
\ Control+Return&sigspace;      \ Display help topic for selected
title in a new window
\ Control+/            \ Select topic tree list
\ Control+&\  \ Deselect topic tree list
<\lablist>


* <term nogloss |Topic Display Area|

<lablist nowrap>
<labheads>\Key     \ Behavior

\ Up Arrow or Left Arrow    \ Move highlight to previous hyperlink
\ Down Arrow or Right Arrow    \ Move highlight to next hyperlink

\ Control+/  \ Select entire topic
\ Control+&\  \ Deselect entire topic
\ Control+C                 \ Copy selection to clipboard
\ Control+V                  \ Paste selection to clipboard
\ Return                    \ Display help topic for the
selected hyperlink
\ Control+Return&sigspace;             \ Display help topic for the
selected hyperlink in a new window
\ Shift+F10            \ Displays the pop-up menu

<\lablist>


* <term nogloss | Help Window|

<lablist nowrap>
<labheads>\Key     \ Behavior

\Escape                                   \Cancels an operation such as
scrolling or resizing. Otherwise, if there is no current operation, closes the help window.
\Alt key+Up Arrow             \ Moves window to top of window stack.
\Alt key+Down Arrow&sigspace;       \ Moves window to bottom of window
stack.
<\lablist>


* <term nogloss | Buttons|


 Press Tab to move the selection highlight to the desired button and
 press Return.

* <term nogloss | Vertical Scroll Bars|

<lablist nowrap>
<labheads>\Key     \ Cursor Movement
\ Up Arrow               \ Scroll up
\ Down Arrow            \ Scroll down
\ Control+Up Arrow    \ Scroll to top of list or topic
\ Control+Down Arrow&sigspace;  \ Scroll to end of list or topic
\ PageUp or Previous     \ Scroll one screen up
\ PageDown or Next   \ Scroll one screen down
<\lablist>

* <term nogloss | Horizontal Scroll Bars|

<lablist nowrap>
<labheads>\Key     \ Cursor Movement
\ Left Arrow             \ Scroll left
\ Control+Left Arrow  \ Scroll to leftmost edge of data
\ Right Arrow            \ Scroll right
\ Control+Right Arrow&sigspace; \ Scroll to rightmost edge of data

<\lablist>

<\list>

<procedure>See Also
<list bullet tight>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>

<s1 id=HelpWindowsAndDialogBoxes>Help Windows And Dialog Boxes

<idx |help window, types of|

<list bullet>

* <xref GeneralHelpWindow>
* <xref Quick-Help>
* <xref HistoryDlg>
* <xref PrintDlg>
* <xref IndexSearchDlg>
* <xref Volume-Select>
* <xref Execution-Policy>
<\list>


<procedure>See Also
<list bullet tight>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>


<s2 id=GeneralHelpWindow>General Help Window

<idx |general help window|
<idx |window, general help|

A general help window has a menu bar, topic tree, and a topic display area.
The topic tree lists help topics that you can choose. The lower portion of
the window&emdash;the topic display area&emdash;displays the selected
topic.

<figure nonumber entity=Help4HelpGeneralHelp>
<\figure>

Any underlined text is a hyperlink.
You use hyperlinks to &dquote;jump&dquote; to other topics.
See <link ToSelectAHelpTopicHyperlink>To Select a Hyperlink<\link> for a description of hyperlinks.

<p>&sigspace;

A general help window has these Help Buttons:

<lablist nowrap>
\Backtrack\      Returns to a previous topic.

\History\       Lists topics and help volumes that you visited and
enables you to redisplay a topic.

\Index\ Opens a help index that you can search to find help
on a subject.
<\lablist>


<p>&sigspace;

<procedure>See Also
<list bullet tight>
 * <xref ToReturnToAPreviousTopic>
 * <xref History>
 * <xref Quick-Help>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>


<s2 id=Quick-Help>Quick Help Window

<idx |quick help window|
<idx |window, quick help|

A quick help window is a streamlined help window. It has a topic display
area and one or more dialog buttons.

<figure nonumber entity=Help4HelpQuickHelp>
<\figure>

<p>&sigspace;

<lablist><labheads>\ Button \ Action
\ Close \      Closes the quick help window
\ Backtrack \  Goes to the previous topic
\ Print \      Displays a Print dialog box
\ Help \       Displays Help on the quick help window
<\lablist>

<procedure>See Also
<list bullet tight>
 * <xref Printing>
 * <xref GeneralHelpWindow>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>

<s2 id=HistoryDlg>History Dialog Box

<idx |Help, History dialog box|

<figure nonumber entity=Help4HelpHistory>
<\figure>

<p>&sigspace;

<lablist nowrap>
\Help Volumes Visited&sigspace;\    Lists help volumes you have visited

\Help Topics Visited\     List topics you have visited
<\lablist>

To return to a volume or help topic, click its title in the History list.

<p>&sigspace;

<procedure>See Also
<list bullet tight>
 * <xref History>
 * <xref HelpWindowsAndDialogBoxes>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>


<s2 id=PrintDlg>Print Dialog Box

<idx |Help, Print dialog box|

<figure nonumber entity=Help4HelpPrintDialog>
<\figure>

<p>&sigspace;

<lablist nowrap>
\ Printer \ The Help System uses your default printer (set by the LPDEST environment variable).

\Copies\ Type the number of copies you want to print.


\Paper Size\ Click the paper size button to display the following choices:

<lablist nowrap>
\Letter\ 8.5 x 11 in
\Legal\ 8.5 x 14 in
\Executive\ 7.25 x 10.5 in
\A4\ 210 x 297 mm
\B5\ 182 x 257 mm
<\lablist>

<\lablist>

<lablist nowrap>
\Topics To Print&sigspace;&sigspace;\ Select the topic or topics to print:

<lablist nowrap>

\ Current Topic\ Print only the displayed topic (the default)

\Current and Subtopics\ Print the current topic
and any subtopics it contains

\Table of Contents and Index&sigspace;\ Print the Table of
Contents and Index of the help volume

\Entire Volume\ Print Table of Contents, Index, and all topics in the help volume
<\lablist>

\Print\ Prints the topic or topics you have chosen

\Cancel\ Closes the Print dialog box

\Help\ Provides a description of the Print dialog box
<\lablist>

<procedure>See Also
<list bullet tight>
 * <xref Printing>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>

<s2 id=IndexSearchDlg>Index Search Dialog Box

<idx |Help, Index Search dialog box|

<figure nonumber entity=Help4HelpIndexDialog>
<\figure>

<procedure>Search

<lablist nowrap>
\Current\ Displays a Help index for the volume that you are viewing. The
current volume is the default.


\All Volumes\ Displays a combined Help index for all help volumes
registered on your system.

\Selected\ Lists available help volumes in a dialog box (see <xref Volume-Select>).
Choose the volumes whose index entries you want to view or search. If you
select volumes and close the dialog box, the Volumes Selected button can
be used to reopen the list of your choices.

<\lablist>

<procedure>Show

<lablist nowrap>
\Complete Index&sigspace;\ Lists all the index entries found for the volume or
volumes you have chosen.

\Entries with:\ Type a word or phrase to search for in the index entries
of the volume or volumes you chose.

<\lablist>

<procedure>Status Line
Indicates if you chose the Complete Index option. If
you search the index, the status line displays the search string or reports "No index entries found".

<procedure>Index Display Area
Lists index entries found for the volume or volumes you chose, or
entries that match the search string you entered.

<lablist nowrap>
\Start Search\ Searches the index for the word or phrase supplied in the
Entries with field. Pressing Return also activates the search.

\Close\ Closes the Index Search dialog box.
<\lablist>

<procedure>See Also
<list bullet tight>
 * <xref Index-Search>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>


<s2 id=Volume-Select>Search Volume Selection Dialog Box

<idx |Help, Index Search Volume Selection dialog box|

<figure nonumber entity=Help4HelpSearchVolume>
<\figure>
<p>&sigspace;

The Search Volume dialog box lists help volumes available on your system.
You can select one or more volumes, whose index entries are then displayed
in the Index Search dialog box. To deselect a volume, click the
volume name again.

When you close the Search Volume dialog box, the Select Volumes button in
the Index Search dialog box can be used to reopen the list of choices.


<procedure>See Also
<list bullet tight>
 * <xref Index-Search>
 * <xref HelpWindowsAndDialogBoxes>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>


<s2 id=Execution-Policy>Execution Link Confirmation Dialog Box

<idx |Help, Execution Link Confirmation dialog box|
<idx |hyperlinks, execution link policy|
<idx |execution link, policy|

An execution hyperlink executes a command instead of displaying
a help topic. Because execution links interact with your
system, you can choose how you want the Help System to respond
when an execution link is selected.

The Help System default behavior is to display a confirmation
dialog box.


<figure nonumber entity=Help4HelpExecutionDlg>
<\figure>

Execution policy is controlled by the Help dialog widget resource
<computer>DtNexecutionPolicy<\computer>.  The default value is
<computer>help_execute_query_unaliased<\computer>.

To change the default behavior, you add the
execution policy resource to your <computer>.Xdefaults<\computer>
file for the application you want to change.

The set of resource values is:

<lablist nowrap>
\<computer>help_execute_all<\computer>\Executes all execution links without
displaying a confirmation dialog box.

\<computer>help_execute_query_unaliased<\computer>\ Displays a dialog box
only for those links which do not have execution aliases defined. An
execution alias is a resource that assigns a name to the command executed
by an execution link.

\<computer>help_execute_query_all<\computer>\Displays a dialog box for all
execution links

\<computer>help_execute_none<\computer>\Disables all execution links, but
displays the execution command in a dialog box

<\lablist>


<procedure>Example
To disable all execution links within your application, perform
these steps:

<list order>
* Create an <computer>.Xdefaults<\computer> file in your home directory or
edit the current <computer>.Xdefaults<\computer> file to include this
resource:

<ex>
<var>application_name<\var>*executionPolicy:help_execute_none
<\ex>

* Replace <emph>application_name<\emph> with the name of the application
you want to change. If you are unsure of the name of the application,
consult your application documentation.

* Start the application.

* To test your change, choose the application Help menu and display a topic
that contains an execution link.
<\list>

<note>Before modifying the execution policy for an application's help
volume, carefully review all execution link commands and their interaction
with your system.  <\note>

<p>&sigspace;
For more information about the Help System execution policy
refer to the <emph>Help System Author's and Programmer's Guide<\emph>.


<procedure>See Also
<list bullet tight>
 * <xref Hyperlinks>
 * <xref HelpWindowsAndDialogBoxes>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>


<s1 id=HelpWindowConfiguration>Help Window Configuration

<idx |help window, color resources|
<idx |color, in help windows|

You can change the colors of the topic tree and topic display
area in a help window. You can also modify the default size of
help windows.

<list bullet>
* <xref ToChangeHelpWindowColorsForAnApplication>
* <xref ToChangeHelpWindowDefaultSize>
<\list>

<procedure>See Also
<list bullet tight>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>



<s2 id=ToChangeHelpWindowColorsForAnApplication>To Change Help Window Colors for an Application

<list order>
* Create an <computer>.Xdefaults<\computer> file in your home directory or
edit your current <computer>.Xdefaults<\computer> file to include the
resources shown in the following example. The name of the color you
have chosen follows the : (colon) in the resource specification.

* Replace <var>application_name<\var> with the name of the application
you want to change. If you do not know the name of the application,
consult your application documentation.

For a list of available colors, check with
your system administrator or refer to your system documentation.

* Start the application.

* To check the new colors, choose the application Help menu.
<\list>


<procedure>Example

This entry changes the background and foreground colors of
the topic tree (TocArea) and topic display area (DisplayArea)
for general help (DtHelpDialog) and quick help (DtHelpQuickDialog)
windows.

Because quick help windows do not have a topic tree, the
<computer>TocArea<\computer> is omitted in the quick help
window resources.

<ex>
<var>application_name<\var>*XmDialogShell.DtHelpDialog*DisplayArea.background: blue
<var>application_name<\var>*XmDialogShell.XmDialogShell.DtHelpDialog*DisplayArea.background: blue
<var>application_name<\var>*XmDialogShell.DtHelpDialog*DisplayArea.foreground: goldenrod
<var>application_name<\var>*XmDialogShell.XmDialogShell.DtHelpDialog*DisplayArea.foreground: yellow
<var>application_name<\var>*XmDialogShell.DtHelpDialog*TocArea.background: blue
<var>application_name<\var>*XmDialogShell*XmDialogShell.DtHelpDialog*TocArea.background: blue
<var>application_name<\var>*XmDialogShell.DtHelpDialog*TocArea.foreground: yellow
<var>application_name<\var>*XmDialogShell*XmDialogShell.DtHelpDialog*TocArea.foreground:yellow


<var>application_name<\var>*XmDialogShell.DtHelpQuickDialog*DisplayArea.background: blue
<var>application_name<\var>*XmDialogShell.XmDialogShell.DtHelpQuickDialog*DisplayArea.background: blue
<var>application_name<\var>*XmDialogShell.DtHelpQuickDialog*DisplayArea.foreground: yellow
<var>application_name<\var>*XmDialogShell.XmDialogShell.DtHelpQuickDialog*DisplayArea.foreground: yellow
<\ex>

<procedure>See Also
<list bullet tight>
 * <xref HelpWindowConfiguration>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>

<s2 id=ToChangeHelpWindowDefaultSize>To Change Help Window Default Size

<idx |help windows, changing default size|

You can change the default window size for general help or quick help
windows by modifying resources. The &dquote;rows&dquote; resource
determines window height and the &dquote;columns&dquote; resource sets
the window width. The display font affects window dimensions.


<list order>

* Create an <computer>.Xdefaults<\computer> file in your home directory or
edit your current <computer>.Xdefaults<\computer> file.

* Choose which resources you want to add from the examples which follow.


* Replace <var>application_name<\var> with the name of the application you
want to change and supply new rows and columns values. If you do not know
the name of the application, consult your application documentation.


* Start the application.

* To check the new window size, choose the application's Help menu. If
  you have modified one of the quick help window types, be sure to
  choose a topic that is displayed in the type of window you have changed.

<\list>

<procedure>Examples

For all general help windows:
<ex>
<var>application_name<\var>*DtHelpDialog.rows: 65
<var>application_name<\var>*DtHelpDialog.columns: 45

<\ex>

For all quick help windows:

<note>The Help System uses a quick help window to display
copyright information, glossary terms, definition links, and
Using Help information. This example changes all instances
of quick help windows.
<\note>

<ex>
<var>application_name<\var>*DtHelpQuickDialog.rows: 25
<var>application_name<\var>*DtHelpQuickDialog.rows: 25

<\ex>

For quick help windows used to display Using Help and copyright
information:

<ex>
<var>application_name<\var>*onHelpDialog.rows: 25
<var>application_name<\var>*onHelpDialog.columns: 25
<\ex>


For definition link quick help windows:

<ex>
<var>application_name<\var>*definitionBox.rows: 10
<var>application_name<\var>*definitionBox.columns: 20

<\ex>


<procedure>See Also
<list bullet tight>
 * <xref HelpWindowConfiguration>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
 <\list>

<s1 id=ErrorMessages>Help Error Messages

<idx |error messages|
<list bullet>
* If the Help System cannot find a help volume, it displays
  this message:

<figure nonumber entity=Help4HelpVolErrMsg>
<\figure>

Possible causes are:
<list bullet>
* The application's help volume is not installed

* Your desktop help search path does not include the directory
  where the help volume has been installed.

Ask your system administrator to verify that the
application's help volume is properly installed and
that your help search paths are set correctly.

<\list>

* If the Help Viewer cannot find the ID of a help topic in a help
  volume, it displays a message like this:

<figure nonumber entity=Help4HelpIdErrMsg>
<\figure>

Possible causes are:
<list bullet>
* A hyperlink points to a topic that does not exist or
whose ID has been changed

* A hyperlink points to a valid ID in another help volume
that is not installed


Ask your system administrator to verify that the
application's help volume is properly installed and
that your help search paths are set correctly.
<\list>


* If the run-time help volume (<computer>.sdl<\computer> file) has an
  error, the Help Viewer displays this message:

<figure nonumber entity=Help4HelpTopicErrMsg>
<\figure>

Possible causes:
<list bullet>
* The run-time help volume may be incomplete or contain an error.

Ask your system administrator to check the help volume.

<\list>
<\list>
<procedure>See Also
<list bullet tight>
 * <xref Reference>
 * <xref Tasks>
 * <xref Table-Of-Contents>
 * <link hyperlink="_hometopic">Home Topic<\link>
<\list>